home *** CD-ROM | disk | FTP | other *** search
/ Hottest 6 / Hottest 6 (1996)(PDSoft)[!].iso / utilities / twin_express / twindoc.txt < prev    next >
Text File  |  1978-11-24  |  80KB  |  2,326 lines

  1.  
  2.   Twin Express                                      User's Guide
  3.  
  4.  
  5.  
  6.                                                 Twin Express 1.1 
  7.                                                     User's Guide 
  8.   
  9.   Copyright 1991 OMNICODE. All rights reserved.
  10.  
  11.   Twin Express                                       User's Guide
  12.  
  13.  
  14.   Copyright:  This  document  and  its  accompanying software are
  15.   copyrighted  by  OMNICODE  (Montréal, CANADA) which retains all
  16.   rights  of  ownership  and  copyright.  Registered  users  have
  17.   specific  rights as stated in the license agreement. Others may
  18.   only  distribute  the  complete  package  as  described  in the
  19.   distribution statement.
  20.   
  21.   Disclaimer:  The  software, the documentation and all the files
  22.   included  in  the  package  are  provided without any warranty.
  23.   Moreover,  OMNICODE  does  not guarantee that the software, the
  24.   documentation  and  the files are accurate, reliable or fit any
  25.   particular  task. The users of this software package accept all
  26.   risks   related   to  its  use.  OMNICODE  shall  not  be  held
  27.   responsible  for any damage, costs or loss arising from the use
  28.   of this software package.
  29.   
  30.   Trademarks:  IBM,  IBM  AT,  IBM  PS/2,  PC-DOS  and  OS/2  are
  31.   registered   trademarks   of  International  Business  Machines
  32.   Corporation.  IBM PC and IBM XT are trademarks of International
  33.   Business   Machines   Corporation.   MS-DOS   is  a  registered
  34.   trademark  of  Microsoft Corporation. Windows is a trademark of
  35.   Microsoft  Corporation.  Amiga  is  a  registered  trademark of
  36.   Commodore-Amiga   Inc.   AmigaDOS   and   Amiga  Workbench  are
  37.   trademarks   of  Commodore-Amiga  Inc.  Unix  is  a  registered
  38.   trademark of AT&T Bell Laboratories.
  39.   
  40.  
  41.   Twin Express                                       User's Guide
  42.  
  43.  
  44.  
  45.   
  46.                          TABLE OF CONTENTS
  47.   
  48.   
  49.   INTRODUCTION................................................ IV
  50.   1 GETTING STARTED...........................................  1
  51.     1.1  Summary of Features..................................  1
  52.     1.2  Installation on the Amiga Computer...................  2
  53.     1.3  Installation on the IBM-PC Computer..................  3
  54.     1.4  The Serial Cable.....................................  4
  55.     1.5  Running Twin Express.................................  5
  56.     1.6  Of Ports and Baud Rates..............................  6
  57.     1.7  Startup Problems.....................................  6
  58.     1.8  Registration.........................................  8
  59.     1.9  Support..............................................  9
  60.   2 TUTORIAL.................................................. 10
  61.     2.1  Vocabulary........................................... 10
  62.     2.2  Purpose of a File Transfer Program................... 10
  63.     2.3  Commands and Aliases................................. 11
  64.     2.4  Local Versus Remote Resources........................ 11
  65.     2.5  Transferring Files with the COPY Command............. 12
  66.     2.6  Syntax of File and Directory Names................... 13
  67.     2.7  File Groups and Wildcards............................ 15
  68.     2.8  Moving Text Files to a Different Type of Computer.... 16
  69.     2.9  Enabling Fast Transfers.............................. 17
  70.     2.10 Input from a Command File............................ 18
  71.   3 COMMANDS.................................................. 19
  72.     3.1  CHDIR................................................ 19
  73.     3.2  COPY................................................. 20
  74.     3.3  DELETE............................................... 21
  75.     3.4  DIR.................................................. 21
  76.     3.5  ECHO................................................. 23
  77.     3.6  HELP................................................. 23
  78.     3.7  MKDIR................................................ 24
  79.     3.8  QUIT................................................. 24
  80.     3.9  RENAME............................................... 24
  81.     3.10 RMDIR................................................ 25
  82.     3.11 SET.................................................. 26
  83.     3.12 SHOW................................................. 26
  84.     3.13 TREE................................................. 27
  85.     3.14 TYPE................................................. 28
  86.   APPENDIX A: Error Messages.................................. A1
  87.   APPENDIX B: License Agreement............................... B1
  88.   APPENDIX C: Distribution Statement.......................... C1
  89.   APPENDIX D: Problem Report Form............................. D1
  90.   APPENDIX E: Registration and Order Form..................... E1
  91.  
  92.  
  93.  
  94.   Twin Express                                       User's Guide
  95.  
  96.  
  97.  
  98.   
  99.                             INTRODUCTION
  100.   
  101.   
  102.           Twin  Express  is a file transfer program that allows a
  103.   user  to  quickly  transfer  files  between two computers via a
  104.   cable  connected  to  their  serial  ports. It is an attractive
  105.   solution  to  the  problem  of  transferring data to a computer
  106.   equipped  with  a  different  type  of  floppy  drive  or  to a
  107.   floppyless  workstation.  It is also an inexpensive alternative
  108.   to  those  time-consuming  exchanges  of  floppy disks and slow
  109.   communication programs.
  110.   
  111.           Speed  is  its  main  feature.  Between  two  12.5  MHz
  112.   AT-type  computers or two Amiga 3000 computers you can transfer
  113.   data  at about 22,000 bytes/second. This is 2 times faster than
  114.   many  other  serial  file transfer utilities and 7 times faster
  115.   than utilities relying on the serial handler of AmigaDos.
  116.   
  117.           Its  second  main  feature  is  its ability to exchange
  118.   files  between  different  types  of  computers (e.g. Amiga and
  119.   IBM-PC).  In  this  case,  it  may  even translate some special
  120.   characters  (e.g.  ±,  £, ½, ß, é, â, ï, ñ) in your text files.
  121.   As  of  December  1991,  the  program  runs  under AmigaDOS and
  122.   PC-DOS  (or MS-DOS). It can also execute as a DOS process under
  123.   Windows and OS/2.
  124.   
  125.           Twin  Express  is  a  shareware  program.  That  is,  a
  126.   program  that  you  can  try before you actually pay for it. As
  127.   such,  you  can copy it, distribute it or store it in a library
  128.   as  long  as  the  package  is  not  modified, not sold and not
  129.   linked  to  any  salable  item.  However,  if  you  install the
  130.   program  on  a  computer  and  decide  to use it after the free
  131.   one-week  evaluation  period  you  must purchase a license from
  132.   OMNICODE.  In  return you become a registered user and are thus
  133.   entitled  to a manual, a diskette containing the latest version
  134.   of  Twin  Express,  an  invoice  (as  proof  of  purchase)  and
  135.   customer support in case of problems.
  136.   
  137.          This   manual   describes   the  features,  installation
  138.   procedures  and  commands  of  Twin  Express.  The  tutorial in
  139.   chapter  2  shows some basic examples of Twin Express commands.
  140.   However,  if  you  just  cannot  wait  to get your hands on the
  141.   keyboard   you   may  want  to  proceed  with  the  information
  142.   available through the on-line HELP command.
  143.   
  144.  
  145.   Twin Express                                       User's Guide
  146.  
  147.  
  148.  
  149.   
  150.                           GETTING STARTED
  151.   
  152.   
  153.           This  chapter  describes the features, the installation
  154.   and  the  start-up  procedures  for Twin Express. Typical error
  155.   messages  plus  suggestions for solutions are outlined in order
  156.   to  help  you  establish  communications between the computers.
  157.   Registration and support sections terminate the chapter.
  158.   
  159.   1.1 SUMMARY OF FEATURES
  160.   
  161.           This  section highlights the most important features of
  162.   Twin Express:
  163.   
  164.     1.  Fast  serial transfers: about 22,000 bytes/second between
  165.         two  12.5  MHz  AT-type  computers or two Amiga computers
  166.         (ram disk to remote ram disk transfers).
  167.   
  168.     2.  Compatible versions run under AmigaDOS and PC-DOS.
  169.   
  170.     3.  Translation  of text files when they are transferred to a
  171.         different  type of computer (useful for transfers between
  172.         Amiga and IBM-PC computers).
  173.   
  174.     4.  Simple,  easy  to  use  commands similar to those used by
  175.         your operating system (e.g. DIR, COPY, RENAME, etc).
  176.   
  177.     5.  Command  name  aliases  compatible  with AmigaDOS, PC-DOS
  178.         and UNIX commands (e.g. MAKEDIR, XCOPY, LS).
  179.   
  180.     6.  Support  for wildcard characters allowing users to select
  181.         a  group  of  files  with a single command. The operation
  182.         can    be    extended   to   include   files   found   in
  183.         subdirectories.
  184.   
  185.     7.  User   may  list  directory  files,  change  the  default
  186.         directories and create or remove directories.
  187.   
  188.     8.  Copies  of  files get the same date stamp as the original
  189.         files.
  190.   
  191.     9.  On-line help.
  192.   
  193.     10. Support for command files (batch files).
  194.   
  195.     11. Transmission   errors  are  detected  and  corrected  (by
  196.         retransmission of bad packets).
  197.   
  198.     12. Support  for ports COM1, COM2, COM3 or COM4 on the IBM-PC
  199.         or compatible computers.
  200.   
  201.     13. Support  for  baud  rates  up  to  115200  on  IBM-PC  or
  202.         compatible computers and 290000 on Amiga computers.
  203.  
  204.  
  205.                               1
  206.  
  207.   Twin Express                                       User's Guide
  208.  
  209.  
  210.  
  211.   
  212.     14. Detection  of  busy ports, incompatible baud rates and of
  213.         non-present,   non-standard   or  malfunctionning  serial
  214.         ports.
  215.   
  216.     15. Distributed  as  a  shareware  program:  "you  can try it
  217.         before you buy it".
  218.   
  219.   1.2 INSTALLATION ON THE AMIGA COMPUTER
  220.   
  221.   Requirements:
  222.   
  223.     1. AmigaDOS 1.2 or higher.
  224.     2. 75K of disk space.
  225.     3. 150K of free memory.
  226.     4. A null-modem cable.
  227.     5. A free serial port (SER: is mandatory).
  228.   
  229.   Distribution files:
  230.   
  231.     1. INSTALL
  232.     2. INSTALL.INFO
  233.     3. README
  234.     4. README.INFO
  235.     5. TWIN
  236.     6. TWIN.INFO
  237.     7. TWINDOC
  238.     8. TWINDOC.INFO
  239.   
  240.   Installation:
  241.   
  242.     1. If  your are using your Amiga with Workbench, activate the
  243.        CLI task by clicking the appropriate icon.
  244.   
  245.     2. Set  the default directory to the directory containing the
  246.        Twin  Express  package. The following example assumes this
  247.        to be the root directory on floppy disk DF0:
  248.   
  249.          CD  DF0:
  250.   
  251.     3. Examine file README for any last-minute changes:
  252.   
  253.          TYPE  README
  254.   
  255.     4. Copy  the  file  TWIN to a directory whose name appears in
  256.        the  search  path of AmigaDos (e.g. utilities, c, system).
  257.        This  way  you can run Twin Express from any directory and
  258.        AmigaDos  will  find  it.  You can use the PATH command to
  259.        display  the  current  search  path. The following example
  260.        assumes  that  the  UTILITIES  directory on disk DH0 is in
  261.        the search path:
  262.   
  263.          PATH
  264.          COPY  TWIN  DH0:UTILITIES
  265.  
  266.  
  267.                               2
  268.  
  269.   Twin Express                                       User's Guide
  270.  
  271.  
  272.  
  273.          COPY  TWIN.INFO  DH0:UTILITIES
  274.   
  275.     5. Print the documentation file TWINDOC:
  276.   
  277.          COPY  TWINDOC  PRT:
  278.   
  279.     6. Connect  one  end  of  a  null-modem cable to the standard
  280.        serial  port  "SER:"  on  the Amiga and the other end to a
  281.        serial  port  on  the remote computer. See section 1.4 for
  282.        details about the serial cable.
  283.   
  284.     7. You  have  one  week  to  evaluate the program. After this
  285.        period  you  must  either  remove  the  program  from your
  286.        system or register your copy.
  287.   
  288.   1.3 INSTALLATION ON THE IBM-PC COMPUTER
  289.   
  290.   Requirements:
  291.   
  292.     1. PC-DOS (MS-DOS) 2.0 or higher.
  293.     2. 75K of disk space.
  294.     3. 150K of free memory.
  295.     4. A null-modem cable.
  296.     5. A free serial port (COM1, COM2, COM3 or COM4) with a ...
  297.          a) standard address (3F8h, 2F8h, 3E8h or 2E8h).
  298.          b) compatible UART chip (8250, 82050, 16450).
  299.          c) standard UART clock of 1.8432 MHz.
  300.   
  301.   Distribution:
  302.   
  303.     1. INSTALL.TXT
  304.     2. README.TXT
  305.     3. TWIN.EXE
  306.     4. TWINDOC.TXT
  307.   
  308.   Installation:
  309.   
  310.     1. If  your are using your IBM-PC with Windows or OS/2, acti-
  311.        vate  the  DOS  environment  by  clicking  the appropriate
  312.        icon.
  313.   
  314.     2. Set  the default directory to the directory containing the
  315.        Twin  Express  package. The following example assumes this
  316.        to be the root directory on floppy disk A:
  317.   
  318.          A:
  319.          CD  \
  320.   
  321.     3. Examine file README.TXT for any last-minute changes:
  322.   
  323.          TYPE  README.TXT
  324.   
  325.     4. Copy  the  file TWIN.EXE to a directory whose name appears
  326.        in  the  search  path  of DOS (e.g. DOS, c, bin). This way
  327.  
  328.  
  329.                               3
  330.  
  331.   Twin Express                                       User's Guide
  332.  
  333.  
  334.  
  335.        you  can  run Twin Express from any directory and DOS will
  336.        find  it.  You  can  use  the  PATH command to display the
  337.        current  search  path.  The following example assumes that
  338.        the DOS directory on disk C is in the search path:
  339.   
  340.          PATH
  341.          COPY  TWIN.EXE  C:\DOS
  342.   
  343.     5. Print the documentation file TWINDOC.TXT:
  344.   
  345.         PRINT  TWINDOC.TXT
  346.   
  347.     6. Connect  one  end  of  a null-modem cable to a serial port
  348.        (COM1  is used by default) on the IBM-PC and the other end
  349.        to  a  serial port on the remote computer. See section 1.4
  350.        for details about the serial cable.
  351.   
  352.     7. You  have  one  week  to  evaluate the program. After this
  353.        period  you  must  either  remove  the  program  from your
  354.        system or register your copy.
  355.   
  356.   1.4 THE SERIAL CABLE
  357.   
  358.           A  null-modem  cable  connects  the  computers by their
  359.   serial  ports.  Such  a cable can be bought in a computer store
  360.   or  can  be  made  from an eight-wire cable and two connectors.
  361.   The  table  below  shows  how  the  different signals are wired
  362.   along   with   the  pinout  in  use  with  different  types  of
  363.   connectors (9 and 25 pins):
  364.   
  365.     ------ CONNECTOR 1 -----        ----- CONNECTOR 2 ------
  366.       DB25     DB9    SIGNAL        SIGNAL    DB9     DB25
  367.   
  368.        07       05       GND  <---> GND       05       07
  369.        02       03        TD  <---> RD        02       03
  370.        03       02        RD  <---> TD        03       02
  371.        05       08       CTS  <---> RTS       07       04
  372.        04       07       RTS  <---> CTS       08       05
  373.        06       06       DSR  <---> DTR       04       20
  374.        20       04       DTR  <---> DSR       06       06
  375.   
  376.   Usually  the serial port has a male connector. The cable should
  377.   therefore  have  two female connectors. However, it is safer to
  378.   verify this before you buy a cable...
  379.   
  380.           There  are  some  null-modem  cables with only 3 wires.
  381.   These  cables  can  also be used with Twin Express. However, it
  382.   is  not  possible  to  select  the high speed transmission mode
  383.   with  such  cables.  There  are  also  null-modem cables with a
  384.   wiring  pattern  different  from  that in the above table. Twin
  385.   Express  is  likely  to  "see"  them  as  3-wire cables. So, be
  386.   careful  before buying a pre-wired cable and compare the wiring
  387.   with the above table.
  388.   
  389.  
  390.  
  391.                               4
  392.  
  393.   Twin Express                                       User's Guide
  394.  
  395.  
  396.  
  397.           You  can also transform a modem cable into a null-modem
  398.   cable  with  a  null-modem  adapter.  You  can  get  an MF-DB25
  399.   adapter  (part  26-1496) or an MF-DB9 adapter (part 26-264) for
  400.   about  8  CAN$  from  Radio  Shack.  This might be a convenient
  401.   solution  if  your  cable  has the proper connectors (usually a
  402.   female connector at each end).
  403.   
  404.   WARNING 1: Do   not   use  a  cable  with  more  than  these  7
  405.              connections  (extra  wires  should be disconnected).
  406.              This  is very important on the AMIGA computers since
  407.              they have a non-standard serial connector.
  408.   
  409.   WARNING 2: Cables  longer  than  20  meters should be used with
  410.              caution.  You  might need to reduce the baud rate or
  411.              use a more expensive low capacitance cable.
  412.   
  413.   WARNING 3: Avoid  putting the cable near appliances. This could
  414.              add  noise to the signals. If this cannot be avoided
  415.              you  might consider buying a more expensive shielded
  416.              cable.
  417.   
  418.   1.5 RUNNING TWIN EXPRESS
  419.   
  420.           You  can  start  up  the  program by typing TWIN at the
  421.   system prompt of the computer:
  422.   
  423.     C> TWIN <enter>
  424.   
  425.   The  program  should  now  display  its version number, a short
  426.   message about the help facility and the TWIN prompt:
  427.   
  428.    TWIN EXPRESS - Version 1.1 released on 1991/12/20 (shareware)
  429.    ~~~~~~~~~~~~   Copyright 1991 OMNICODE. All rights reserved.
  430.   
  431.    HELP:
  432.   
  433.      ... Some information on HELP ...
  434.   
  435.    TWIN>
  436.   
  437.   At  this  point,  Twin  Express  waits  for the user to type in
  438.   commands or to receive a request from the remote computer.
  439.   
  440.           If  Twin Express is also running on the remote computer
  441.   and  a  cable is connected to the default ports (COM1 on the PC
  442.   and  SER  on the Amiga) you should get the following message on
  443.   both screens:
  444.   
  445.    >>> Communication is established with the remote computer <<<
  446.   
  447.   This  message indicates that you are ready to transfer files to
  448.   the  remote  computer.  If  it does not appear see sections 1.6
  449.   and 1.7 for help.
  450.   
  451.  
  452.  
  453.                               5
  454.  
  455.   Twin Express                                       User's Guide
  456.  
  457.  
  458.  
  459.   1.6 OF PORTS AND BAUD RATES
  460.   
  461.           By  default,  Twin  Express uses port COM1 on an IBM PC
  462.   and  SER  on  an  Amiga. In both cases the default baud rate is
  463.   115200.
  464.   
  465.           It  is  possible  to  use  baud  rates  other  than the
  466.   default  value  and, on IBM compatible computers, to use a port
  467.   other  than  COM1.  Ports COM1, COM2, COM3 and COM4 can be used
  468.   on  the  IBM  PC or compatible systems. Only SER can be used on
  469.   the Amiga.
  470.   
  471.           The  baud rates available on both machines are: 115200,
  472.   57600,  38400,  19200  and 9600. The Amiga version also accepts
  473.   the  following  baud  rates:  130000,  150000,  170000, 190000,
  474.   210000,   230000,   250000,   270000   and  290000  (190000  is
  475.   recommended).
  476.   
  477.           To   change  a default value, the user must supply both
  478.   the  port and the baud rate as parameters to TWIN. For example,
  479.   to  communicate  at  57600  baud  using  port  COM2  on the IBM
  480.   compatible:
  481.   
  482.     C> TWIN  COM2  57600
  483.   
  484.   whilst the command for the Amiga is:
  485.   
  486.     1> TWIN  SER  57600
  487.   
  488.   1.7 STARTUP PROBLEMS
  489.   
  490.           This  section  highlights the most common problems that
  491.   a  user  might  encounter  in  establishing  communication.  It
  492.   presents  error messages along with suggestions for solving the
  493.   problem. More general errors are discussed in appendix A.
  494.   
  495.   >>> Communication is established with the remote computer <<<
  496.   does not appear on the screen of computers.
  497.   
  498.     First,  verify  that  the  cable  is  connected to the serial
  499.     ports  on both computers. Second, make sure that Twin Express
  500.     has  been activated on both machines with the proper port and
  501.     baud   rate.   Third,  check  the  programs  running  in  the
  502.     background.  Some  of them might "steal" too many CPU cycles.
  503.     Fourth,  examine  the  cable.  Is  it  a null-modem cable? Is
  504.     there a bad connection (connectors, wires, etc)?
  505.   
  506.   Error: Unrecognized device
  507.   
  508.     An  invalid  serial  device  has  been used as a parameter to
  509.     Twin  Express.  Re-execute  the program with one of the valid
  510.     devices specified in section 1.6.
  511.   
  512.   Error: Unrecognized speed
  513.  
  514.  
  515.                               6
  516.  
  517.   Twin Express                                       User's Guide
  518.  
  519.  
  520.  
  521.   
  522.     An  invalid  baud  rate  has been specified as a parameter to
  523.     Twin  Express.  Note that you must also specify a device when
  524.     you  indicate a baud rate. Re-execute the program with one of
  525.     the valid baud rates specified in section 1.6.
  526.   
  527.   Error: Cannot get pathname of current default directory
  528.   Error: Cannot establish an abort receiver
  529.   
  530.     These  are  internal  errors.  They  should not occur. Please
  531.     contact  OMNICODE  (fill  in and mail the problem report form
  532.     in appendix D).
  533.   
  534.   Error: This protocol cannot be used with a 3-wire cable
  535.   
  536.     This  error  may  occur  when  a  user selects the high speed
  537.     transmission  mode  with  the  SET  MODE  command.  This mode
  538.     requires  a  7-wire  cable  as defined in section 1.4. First,
  539.     check  your  cable.  Second,  use only the STANDARD mode with
  540.     3-wire cables.
  541.   
  542.   Error: Mode EXPRESS failed to initialize properly
  543.   
  544.     This  error  may  occur  when  a  user selects the high speed
  545.     transmission  mode  with  the  SET MODE command. It indicates
  546.     that  transfers would not be reliable using this mode. It may
  547.     occur  on  some  computers,  especially  with long cables. In
  548.     this case you must use the default STANDARD mode.
  549.   
  550.   >>> Non-present or non-standard device <<<
  551.   
  552.     The  selected  serial port was not found in the system or, if
  553.     found,  it  does not appear to be a serial device. This error
  554.     may  occur if the user selects a device that is not installed
  555.     (e.g.  COM4), if a serial device has been installed at a non-
  556.     standard  address  (e.g. COM1 address different from 3F8h) or
  557.     if  a  different  type  of  hardware has been installed at an
  558.     address  normally  assigned to a serial device. First, try to
  559.     execute  Twin  Express  with  a different device (e.g. COM2).
  560.     Second,  check the address of your serial port and compare it
  561.     with the addresses defined in section 1.3.
  562.   
  563.   >>> Malfunctionning serial device <<<
  564.   
  565.     The  serial  device does not appear to work correctly. First,
  566.     verify  that  your serial port works with a different type of
  567.     software.  Second,  compare the type of the UART chip of your
  568.     serial port with those listed in the installation section.
  569.   
  570.   >>> Selected serial device appears to be busy <<<
  571.   
  572.     The  serial  port seems to be connected to an external device
  573.     (e.g.  modem,  printer). This error is likely to occur if you
  574.     execute  Twin  Express with the default port and this port is
  575.  
  576.  
  577.                               7
  578.  
  579.   Twin Express                                       User's Guide
  580.  
  581.  
  582.  
  583.     connected  to a device. It may also occur if you disconnected
  584.     an  external  device  from  a serial port in order to connect
  585.     the  null-modem  cable.  First,  make  sure  to  execute Twin
  586.     Express  with  the  appropriate  serial  port. Second, if the
  587.     message   appears  only  on  one  computer,  re-execute  Twin
  588.     Express  on  this  computer otherwise you will need to reboot
  589.     both systems.
  590.   
  591.   >>> Local computer is too slow for current baud rate <<<
  592.   >>> Remote computer is too slow for current baud rate <<<
  593.   
  594.     These  messages  indicate  that a computer is not fast enough
  595.     to  communicate at the current baud rate. It may occur if you
  596.     try  to  execute  Twin  Express  on  an  Amiga  500/1000/2000
  597.     computer  with  a baud rate exceeding 190000 or on a 4.77 MHz
  598.     PC-type  computer  with a baud rate of 115200. Try again with
  599.     a lower baud rate.
  600.   
  601.   >>> Remote computer appears to use a different baud rate <<<
  602.   
  603.     This  message  is  displayed  when  a  computer receives many
  604.     unrecognized  characters  from  the  serial  port. It usually
  605.     occurs  when  the  program is activated with a different baud
  606.     rate  on  each  computer.  Note  that  this  error is usually
  607.     displayed  on  the  screen of the computer having the fastest
  608.     baud  rate.  It  may  also  occur if you use a high baud rate
  609.     (e.g.  290000)  with a long cable or if your serial port does
  610.     not  use  a  standard  clock  rate.  First,  re-execute  both
  611.     programs  with  the same baud rate. Second, try to reduce the
  612.     baud  rate on the machine that does show this message. Third,
  613.     try  with  a  lower baud rate (e.g. 57600). Fourth, make sure
  614.     that  you  use  the  serial ports connected to the null-modem
  615.     cable.  Fifth,  compare  the  clock  rate of your serial port
  616.     with the value found in the installation section.
  617.   
  618.   1.8 REGISTRATION
  619.   
  620.           Twin  Express  is  a  shareware package. It is not free
  621.   software  nor  public domain software. The main difference here
  622.   is  that  you  must  purchase  a  license  to  use  it after an
  623.   evaluation  period.  Note that the cost of the license is never
  624.   included   in  the  price  of  disks  from  public  domain  and
  625.   shareware software distributors. 
  626.   
  627.            The  package  contains  files  that  can be evaluated,
  628.   free  of  charge,  during  a one-week period. During this week,
  629.   you  can  test the program and examine the documentation. After
  630.   this  period,  you  must decide if you want to keep the program
  631.   or  not.  If the product is found to be not useful, the package
  632.   must  be  removed from the system. However, if you do decide to
  633.   keep  it,  you  must  become  a registered user by purchasing a
  634.   license from OMNICODE.
  635.   
  636.            The  cost  of  a  basic license for two machines is 30
  637.  
  638.  
  639.                               8
  640.  
  641.   Twin Express                                       User's Guide
  642.  
  643.  
  644.  
  645.   CAN$  (including  Canadian taxes where applicable). Add to this
  646.   an  extra  fee  of 10 CAN$ for each additional machine. If Twin
  647.   Express  is  to  be  installed  on  a  server,  you will need a
  648.   license  for  every  computer  that can access the program from
  649.   the   server.  Upon  registration,  you  receive  a  manual,  a
  650.   diskette  containing  the  latest  version  of Twin Express, an
  651.   invoice  (as  proof  of  purchase)  and support for 6 months in
  652.   case  of problems. The registration and order form can be found
  653.   in appendix E.
  654.   
  655.   1.9 CUSTOMER SUPPORT
  656.   
  657.           You  might  experience problems with the program or the
  658.   documentation  or  you  might  just  want  to obtain the latest
  659.   release.  Registered  users  can  contact OMNICODE to get help.
  660.   Just send a letter or a FAX to:
  661.   
  662.                      OMNICODE
  663.                      P.O. Box 128 Ahuntsic
  664.                      Montréal [Québec]
  665.                      CANADA H3L 3N7
  666.   
  667.                      FAX: (514)385-6455
  668.   
  669.   You  will  find  a problem report form in appendix D to be used
  670.   in  describing  your  problems and for making suggestions. Fill
  671.   in the form in appendix E in order to get the latest update.
  672.   
  673.  
  674.                           9
  675.  
  676.   Twin Express                                       User's Guide
  677.  
  678.  
  679.  
  680.   
  681.                              TUTORIAL
  682.   
  683.   
  684.           This  chapter  introduces the new user to Twin Express.
  685.   The  experienced  user  is  referred  to  chapter  3  for  more
  686.   detailed information.
  687.   
  688.           We   assume   here   that  the  installation  has  been
  689.   completed  and  that  a  cable  is  connected  between  the two
  690.   computers running Twin Express.
  691.   
  692.   2.1 VOCABULARY
  693.   
  694.           D.O.S.  means  Disk  Operating  System. Throughout this
  695.   manual,  this  term  is  used  without designating a particular
  696.   implementation of this software (e.g. PC-DOS, UNIX).
  697.   
  698.           A  null-modem  cable  is  a  cable that connects to the
  699.   serial  ports of two computers. This is not the same as a modem
  700.   cable (the wiring is different).
  701.   
  702.           Serial  transfers  means  data transmission between two
  703.   computers by their serial devices through a null-modem cable.
  704.   
  705.           Remote  system  indicates  the  computer  to which your
  706.   computer   (known   as  the  local  system)  is  connected.  By
  707.   extension,  remote  files,  remote directories, remote volumes,
  708.   remote   devices   and   remote   resources   indicates  files,
  709.   directories,  volumes,  devices  and  resources  located on the
  710.   remote system.
  711.   
  712.           A  volume  is  a  structured  group  of directories and
  713.   files,  sometimes  called a file system, installed on a disk, a
  714.   disk partition or in a dedicated area of the main memory.
  715.   
  716.   2.2 PURPOSE OF A FILE TRANSFER PROGRAM
  717.   
  718.           The  purpose  of a file transfer program is to transfer
  719.   files  between  two  computers.  It  allows  a user to exchange
  720.   files   between   computers  equipped  with  floppy  drives  of
  721.   different   sizes  or  to  exchange  files  with  a  floppyless
  722.   computer.  It  performs  this  job better than a communications
  723.   program  since  it  is usually much faster and adapted for this
  724.   task.  Finally,  it  is  also  simpler  and faster then using a
  725.   floppy  disk  to  transfer  files between the hard disks of two
  726.   computers  (especially  when  the size of a file is larger than
  727.   the capacity of the floppy disk).
  728.   
  729.           A  file  transfer  program  needs  a  link  between the
  730.   computers  involved  in  these  transfers.  This can be done by
  731.   connecting  a  cable  to a serial port on each computer. Such a
  732.   port  works  with  fairly long cables, provides some protection
  733.   against noise and is inexpensive.
  734.  
  735.  
  736.                              10
  737.  
  738.   Twin Express                                       User's Guide
  739.  
  740.  
  741.  
  742.   
  743.   2.3 COMMANDS AND ALIASES
  744.   
  745.           The   user   interacts  with  Twin  Express  by  typing
  746.   commands  that  have  a  name  similar  to the commands of your
  747.   D.O.S.  For  example,  to  get  a list of the files kept in the
  748.   local current directory:
  749.   
  750.     TWIN> DIR <enter>
  751.   
  752.   The full set of commands is given in the table below:
  753.   
  754.     DIR    : Shows file(s) in a directory.
  755.     CHDIR  : Changes the default directory.
  756.     MKDIR  : Creates a directory.
  757.     RMDIR  : Removes a directory.
  758.     TREE   : Shows directory structure.
  759.     COPY   : Makes a copy of file(s).
  760.     DELETE : Deletes file(s).
  761.     RENAME : Changes the name of file(s).
  762.     TYPE   : Shows the contents of a text file.
  763.     HELP   : Provides help on Twin Express.
  764.     SET    : Changes the transmission mode.
  765.     SHOW   : Displays various information.
  766.     ECHO   : Outputs a string on the console.
  767.     QUIT   : Exits from Twin Express.
  768.   
  769.           In  order  to  assist  the  users  who  transfer  files
  770.   between  systems  having  two  different  D.O.S.,  Twin Express
  771.   accepts  popular  aliases  for some commands and options. These
  772.   aliases are shown in the table below:
  773.   
  774.     DIR     : LIST, LS
  775.     CHDIR   : CD
  776.     MKDIR   : MD, MAKEDIR
  777.     RMDIR   : RD
  778.     COPY    : XCOPY, CP
  779.     DELETE  : DEL, ERASE, RM
  780.     RENAME  : REN, MV
  781.     TYPE    : MORE, CAT, DISPLAY
  782.     HELP    : ?
  783.     QUIT    : EXIT
  784.   
  785.     SUBDIR  : ALL, /S
  786.   
  787.   This  feature should help those who are used to PC-DOS, MS-DOS,
  788.   AmigaDOS  or  UNIX.  However,  Twin Express commands have their
  789.   own  behavior  and  options.  Therefore, they may not recognize
  790.   certain  options  or perform exactly like their counterparts in
  791.   these operating systems.
  792.   
  793.   2.4 LOCAL VERSUS REMOTE RESOURCES
  794.  
  795.  
  796.  
  797.  
  798.                              11
  799.  
  800.   Twin Express                                       User's Guide
  801.  
  802.  
  803.  
  804.   
  805.           All   the   commands   related  to  file  or  directory
  806.   operations  can  work  on  local  or  remote  resources.  These
  807.   resources may be: files, directories, volumes and devices.
  808.   
  809.           Accessing  a local resource is simple. You just specify
  810.   the  name  of  the  resource  in  your command. For example, to
  811.   delete the local file OLDDEMO.C:
  812.   
  813.     TWIN> DELETE  OLDDEMO.C
  814.   
  815.   Unless  otherwise  specified,  Twin  Express  always uses local
  816.   resources.  In the example above, the program deletes the local
  817.   file  OLDDEMO.C  from  the  local default directory. You always
  818.   have  access  to  the  local resources even if no communication
  819.   has been established with a remote computer.
  820.   
  821.           Accessing  a  remote resource is simple too! This time,
  822.   the  name  of  the  resource  must have a ~ prefix (tilde). For
  823.   example, to delete the remote file OLDDEMO.C:
  824.   
  825.     TWIN> DELETE  ~OLDDEMO.C
  826.   
  827.   In  this case, the request is sent to the remote computer where
  828.   it   is  executed.  In  the  example  above,  the  remote  file
  829.   OLDDEMO.C   is  deleted  from  the  remote  default  directory.
  830.   Communication  must  have been established with a remote system
  831.   before you can use commands specifying remote resources.
  832.   
  833.           The  procedure  is the same with all the commands. Twin
  834.   Express  uses  a remote resource if the name has a ~ prefix and
  835.   a  local  resource  otherwise.  The commands themselves are the
  836.   same  for both the local and the remote operations. Note: there
  837.   must  be  no  space  between  the  ~ prefix and the name of the
  838.   resource.
  839.   
  840.   2.5 TRANSFERRING FILES WITH THE COPY COMMAND
  841.   
  842.           The  main purpose of a file transfer program is to copy
  843.   files  from one computer to another. With Twin Express, this is
  844.   done by the COPY command.
  845.   
  846.           This  command  can  work  with  both  local  and remote
  847.   files.  To  copy  a  file  between  two  computers it is just a
  848.   matter  of  using a local name and a remote name.  For example,
  849.   to  copy  the  local file ALPHA to the file Bravo on the remote
  850.   computer:
  851.   
  852.     TWIN> COPY  ALPHA  ~Bravo
  853.   
  854.   This  command actually transfers a copy of the local file ALPHA
  855.   to  the  remote  system  since  the ~ prefix specifies a remote
  856.   file.  The  new  file  is  stored  as  file Bravo in the remote
  857.   default   directory.  Note:  whenever  possible,  Twin  Express
  858.  
  859.  
  860.                              12
  861.  
  862.   Twin Express                                       User's Guide
  863.  
  864.  
  865.  
  866.   preserves lower case letters used in file and directory names.
  867.   
  868.           The  target  name  of the COPY command can be a device.
  869.   For  example,  to print the local file README.DOC, you can copy
  870.   it to the remote printer PRT:
  871.   
  872.     TWIN> COPY  README.DOC  ~PRT:
  873.   
  874.   The  following  devices  are  available  on the Amiga computer:
  875.   CON:,  PRT: and NIL:. SER: can also be used locally if the port
  876.   is  not  connected  to a remote computer. The following devices
  877.   are  available  on  the  IBM-PC  or  compatible  systems: CON:,
  878.   COM1:, COM2:, LPT1:, LPT2:, LPT3:, PRN: and NUL:.
  879.   
  880.           Of  course, you can also copy a remote resource to your
  881.   local  system.  For example, to copy the remote file CHARLIE to
  882.   the local file DELTA:
  883.   
  884.     TWIN> COPY  ~CHARLIE  DELTA
  885.   
  886.   This  time,  a copy of the file CHARLIE is transferred from the
  887.   remote  to  the local system. The command is the same as before
  888.   but the remote resource is now the source file.
  889.   
  890.            The  source  file and the destination file may also be
  891.   located  on  the  same computer. For example, to copy the local
  892.   file ALPHA to the local file BRAVO:
  893.   
  894.     TWIN> COPY  ALPHA  BRAVO
  895.   
  896.   No  transfer  occurred  between  the  computers,  in this case,
  897.   because  both  names  specified  local files. A remote copy can
  898.   also  be  done if both names specify remote files. For example,
  899.   to copy the remote file CHARLIE to the remote file DELTA:
  900.   
  901.     TWIN> COPY  ~CHARLIE  ~DELTA
  902.   
  903.   With  such  an  operation,  the  request  is sent to the remote
  904.   system  where  it  is  executed locally. This kind of operation
  905.   can  be useful if you have to perform some disk management on a
  906.   distant remote system.
  907.   
  908.           The  thing  to  remember  here:  COPY always performs a
  909.   file  transfer whenever one name specifies a local resource and
  910.   the  other  name  a  remote  resource. Otherwise, it is a plain
  911.   copy.
  912.   
  913.   2.6 SYNTAX OF FILE AND DIRECTORY NAMES
  914.   
  915.           By  using  only  simple  file  names, like CHESS.C, the
  916.   user  can access only the files in the local and remote default
  917.   directories.  These  directories  correspond to the directories
  918.   in  use  on  the  local and remote system when Twin Express was
  919.   activated.
  920.  
  921.  
  922.                              13
  923.  
  924.   Twin Express                                       User's Guide
  925.  
  926.  
  927.  
  928.   
  929.           Twin  Express  also  accepts  file names that specify a
  930.   path  to  reach  the selected file or directory. Such names are
  931.   often  called  pathnames.  The  path  may contain a volume name
  932.   and/or directory names.
  933.   
  934.           Directory  and file names must be separated by either /
  935.   (slashes)  or  \  (back-slashes).  For  example, to delete file
  936.   CHESS.C from subdirectory SOURCES in subdirectory GAMES:
  937.   
  938.     TWIN> DELETE  GAMES/SOURCES/CHESS.C               or
  939.     TWIN> DELETE  GAMES\SOURCES\CHESS.C
  940.   
  941.   The  choice  between  / and \ is yours; you can use both on all
  942.   the  systems. To specify the root directory (the main directory
  943.   on  a  volume)  you can use, as well, the slash, the back-slash
  944.   or  the  colon.  For  example:  to  change  the  local  default
  945.   directory to the root directory of the current volume:
  946.   
  947.     TWIN> CHDIR  /                                    or
  948.     TWIN> CHDIR  \                                    or
  949.     TWIN> CHDIR  :
  950.   
  951.   However,  a path may start with a volume name. This name may be
  952.   the   physical   name  of  a  disk  (e.g.  DH0,  E)  or,  where
  953.   applicable,  the  volume  name  specified during a disk format.
  954.   When  a  volume  name  is included in a path, this name must be
  955.   followed  by a colon. For example, to remove directory TRASH on
  956.   remote volume DH0:
  957.   
  958.     TWIN> RMDIR  ~DH0:TRASH
  959.   
  960.   A  volume  name  also  forces  the  path  to  start at the root
  961.   directory  of  this  volume.  Note:  this behavior is different
  962.   from  PC-DOS  and  MS-DOS  where the path starts at the current
  963.   default  directory (unless a \ is used). Actually, Twin Express
  964.   accepts  all  the  following  pathnames  to reach the directory
  965.   DEMOS on volume C:
  966.   
  967.     TWIN> CHDIR  C:/DEMOS
  968.     TWIN> CHDIR  C:\DEMOS
  969.     TWIN> CHDIR  C:DEMOS
  970.     TWIN> CHDIR  :/DEMOS
  971.     TWIN> CHDIR  :\DEMOS
  972.     TWIN> CHDIR  /DEMOS
  973.     TWIN> CHDIR  \DEMOS
  974.     TWIN> CHDIR  :DEMOS
  975.   
  976.   The  last  five  commands above assume that the directory DEMOS
  977.   is  on  the  current default volume. Again, you have the choice
  978.   of  selecting  the  pathname syntax that most resembles that of
  979.   your  system  even  when you transfer files to/from a different
  980.   D.O.S.
  981.   
  982.  
  983.  
  984.                              14
  985.  
  986.   Twin Express                                       User's Guide
  987.  
  988.  
  989.  
  990.   2.7 FILE GROUPS AND WILDCARDS
  991.   
  992.           Quite  often,  the user needs to transfer more than one
  993.   file:  it  may  be all the files in a directory, C source files
  994.   or  only  the  files  having  a  name starting with HOTEL. Some
  995.   commands  (DIR,  COPY,  DELETE and RENAME) accept the popular *
  996.   and  ?  wildcard  characters  in  order  to  specify a group of
  997.   files.
  998.   
  999.           The  ?  wildcard character matches any single character
  1000.   in  a  file name. For example, to list all the four-letter file
  1001.   names starting with L and ending with MA:
  1002.   
  1003.     TWIN> DIR  L?MA
  1004.   
  1005.   The  * wildcard character matches any number of characters in a
  1006.   file  name.  For  example,  to delete all the files ending with
  1007.   .BAK:
  1008.   
  1009.     TWIN> DELETE  *.BAK
  1010.   
  1011.   Twin  Express  also  lets  you specify the variable part of the
  1012.   file  name  with  a selection from a set of substrings. In this
  1013.   case,  the  substrings  are separated by | and the complete set
  1014.   is  enclosed  by (). For example, to list the .C files starting
  1015.   with TWIN and ending with either HOST, COMM or MAIN:
  1016.   
  1017.      TWIN> DIR  TWIN(HOST|COMM|MAIN).C
  1018.   
  1019.   Of  course  the  selection can be combined with wildcards; this
  1020.   can  be  quite  powerful.  For example, to delete all the files
  1021.   ending with .LST, .MAP or .BAK:
  1022.   
  1023.     TWIN> DELETE  *.(LST|MAP|BAK)
  1024.   
  1025.   However,  the  selection and wildcards can be used only in file
  1026.   names.  They  cannot  be  used  in  a path (i.e. volume name or
  1027.   directory name).
  1028.   
  1029.           The  * wildcard character, alone, can also be used in a
  1030.   target  name.  For example, to copy all the .EXE files from the
  1031.   local subdirectory PROJECTS to the remote subdirectory TESTS:
  1032.   
  1033.     TWIN> COPY  PROJECTS/*.EXE  ~TESTS/*              or
  1034.     TWIN> COPY  PROJECTS/*.EXE  ~TESTS
  1035.   
  1036.   As  shown  above,  the  * wildcard character in the target name
  1037.   matches  the  corresponding files of the source name. Actually,
  1038.   this   is   equivalent  to  the  second  command  which  simply
  1039.   specifies  the  target  directory.  However,  when  the  target
  1040.   directory  is  a  default  directory,  the * wildcard character
  1041.   reduces  the number of characters to type. For example, to copy
  1042.   the local file CHESS.C to the remote default directory:
  1043.   
  1044.  
  1045.  
  1046.                              15
  1047.  
  1048.   Twin Express                                       User's Guide
  1049.  
  1050.  
  1051.  
  1052.     TWIN> COPY  CHESS.C  ~*
  1053.   
  1054.           It  may  be  useful  to abort a command when a group of
  1055.   files  is  specified.  This  may  occur,  for example, when you
  1056.   delete,  by  error, the wrong group of files! In this case, the
  1057.   command may be aborted by typing <CTRL-C>.
  1058.   
  1059.   2.8 MOVING TEXT FILES TO A DIFFERENT TYPE OF COMPUTER
  1060.   
  1061.           An  important feature of Twin Express is its ability to
  1062.   transfer  files  between  different  types  of  computers (e.g.
  1063.   between  Amiga  and  IBM-PC  computers).  This is of particular
  1064.   interest  for  text files since binary files containing data or
  1065.   programs  are  almost  useless on a different type of computer.
  1066.   Text  files  contain  printable  characters.  They  are used to
  1067.   store letters, documents, ASCII data and source programs.
  1068.   
  1069.           Unfortunately,  each  computer  has  its  own  internal
  1070.   organization  for  text  files. The end-of-line marker, end-of-
  1071.   file  marker  and  the  coding of special characters may change
  1072.   from one computer to another.
  1073.   
  1074.           At  this  time, Twin Express handles the translation of
  1075.   the  end-of-line  marker,  the  end-of-file  marker and 50 non-
  1076.   standard  characters  common  to  both Amiga and IBM compatible
  1077.   computers.   The   changes   are  described  in  the  following
  1078.   paragraphs:
  1079.   
  1080.     1. The  end-of-line  marker  is  translated  between  NL (new
  1081.        line)  on  the  Amiga  and  CR/LF  (carriage return / line
  1082.        feed) on the IBM-PC or compatible computers.
  1083.   
  1084.     2. A  <CTRL-Z>  marker  is  appended  to  the end of all text
  1085.        files  on  IBM-PC  or  compatible  computers.  Note:  this
  1086.        marker  is  added  even  if the marker is missing from the
  1087.        source file.
  1088.   
  1089.     3. The  Amiga  and IBM-PC machines share 50 characters having
  1090.        the   same   typeface  but  a  different  code.  A  simple
  1091.        translation  is  done  in this case. These characters are:
  1092.        á,  à,  â, ä, é, è, ê, ë, í, ì, î, ï, ó, ò, ô, ö, ú, ù, û,
  1093.        ü,  ÿ,  ç, Ç, É, Ä, Ö, Ü, ¿, ¡, ñ, Ñ, å, Å, æ, Æ, ß, µ, ¥,
  1094.        ±,  £, ¢, ¬, °, ², «, »,  , Ø, ¼, ½. The remaining special
  1095.        characters are left unmodified.
  1096.   
  1097.           The  TEXT option of the COPY command indicates that the
  1098.   source  file  contains  text rather than binary or raw data. It
  1099.   enables  the  translation  process. It is not required when the
  1100.   transfer  is done to the same type of computer. For example, to
  1101.   transfer  the  text  file  TWIN.DOC from the local directory to
  1102.   the file TWIN.TXT on a different remote computer:
  1103.   
  1104.     TWIN> COPY  TWIN.DOC  ~TWIN.TXT  TEXT
  1105.   
  1106.  
  1107.  
  1108.                              16
  1109.  
  1110.   Twin Express                                       User's Guide
  1111.  
  1112.  
  1113.  
  1114.           The  TYPE  command displays on screen the contents of a
  1115.   text  file. Twin Express automatically translates the file to a
  1116.   format  compatible  with  the local computer when the file is a
  1117.   remote  file from a different type of computer. For example, to
  1118.   display the contents of the remote file SONGS.SPA:
  1119.   
  1120.     TWIN>  TYPE  ~SONGS.SPA
  1121.   
  1122.   The  TYPE  command  assumes  that  SONGS.SPA is a text file and
  1123.   translates it, if necessary.
  1124.   
  1125.           A   word   of  caution  about  word  processors.  These
  1126.   programs  keep  some  formating information in your text files.
  1127.   This  information  may  change  from  one  type  of computer to
  1128.   another.   Twin   Express  does  not  translate  this  type  of
  1129.   information.  Therefore  you  may  want  to  transfer  the file
  1130.   without  the  TEXT option and then use a conversion program. On
  1131.   the  other hand, if the word processor output can be redirected
  1132.   to  an ASCII file, instead of the printer, this output file can
  1133.   be  transferred  with the TEXT option since it does not contain
  1134.   the formating information.
  1135.   
  1136.   2.9 ENABLING FAST TRANSFERS
  1137.   
  1138.           The  main  feature  of  Twin Express is its speed. High
  1139.   speed  serial  transfers  can  be achieved by using a high baud
  1140.   rate and/or a special transmission mode.
  1141.   
  1142.           On  the  Amiga computer, the hardware can transfer more
  1143.   than  1,000,000 bits per second (according to Commodore-Amiga).
  1144.   To   get   the  fastest  serial  transfers  between  two  Amiga
  1145.   computers  it  is  thus  a matter of selecting the highest baud
  1146.   rate  possible. In practice, this baud rate is actually limited
  1147.   by  CPU  speed  and  cable  capacitance  (ability  to oppose to
  1148.   changing  voltages).  The highest baud rate recommended for the
  1149.   Amiga  family  of computers is 190000. However, if you have two
  1150.   Amiga  3000  and  a short cable you may use baud rates of up to
  1151.   290000. For example, to execute Twin Express at 230000 baud:
  1152.   
  1153.     A> TWIN  SER  230000
  1154.   
  1155.   With  such  a  baud rate, the effective transfer speed is about
  1156.   22,000  bytes  per  second.  Raising  the  baud  rate, from its
  1157.   default  115200  baud,  is  the  recommended method to get high
  1158.   speed serial transfers between two Amiga computers.
  1159.   
  1160.           On  a  12.5  MHz  AT-type  computer,  the  hardware can
  1161.   transfer  data  at  up  to  115200  bits  per  second. Speed is
  1162.   actually  limited  by  the  hardware,  not  by  the CPU. To get
  1163.   faster  speeds,  the  user  must  select a special transmission
  1164.   mode  (EXPRESS).  On  a 12.5 MHz AT-type computer, it transfers
  1165.   about  100%  more  data  than  the  default  STANDARD mode. For
  1166.   example, to enable the EXPRESS mode:
  1167.   
  1168.  
  1169.  
  1170.                              17
  1171.  
  1172.   Twin Express                                       User's Guide
  1173.  
  1174.  
  1175.  
  1176.     TWIN> SET  MODE  EXPRESS
  1177.   
  1178.   This  allows a user to transfer files at about 22,000 bytes per
  1179.   second  using the default baud rate of 115200. You can also use
  1180.   this  mode with Amiga computers. However, with a high baud rate
  1181.   the increase in performance is lower.
  1182.   
  1183.           The  EXPRESS  mode  is the recommended mode of transfer
  1184.   unless  you  are  using a 3-wire cable or you run into a lot of
  1185.   transmission errors.
  1186.   
  1187.   2.10 INPUT FROM A COMMAND FILE
  1188.   
  1189.           Twin  Express  reads  its  commands  from  the standard
  1190.   input   file   used  upon  activation.  This  file  is  usually
  1191.   connected  to  the keyboard. However, it is possible to execute
  1192.   commands  from a disk file. The user just needs to redirect the
  1193.   standard  input  to  this  file.  For  example,  to execute the
  1194.   commands in file BACKUP.TNX:
  1195.   
  1196.     TWIN  <BACKUP.TNX
  1197.   
  1198.   The  file contains the same commands as would be entered from a
  1199.   keyboard, including the final QUIT command. For example:
  1200.   
  1201.     COPY  C:*.C  ~D:  SUBDIR  TEXT
  1202.     COPY  C:*.ASM  ~D:  SUBDIR  TEXT
  1203.     QUIT
  1204.   
  1205.   Note: commands files can be created with any text editor.
  1206.   
  1207.   
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.                              18
  1233.  
  1234.   Twin Express                                       User's Guide
  1235.  
  1236.  
  1237.  
  1238.   
  1239.                               COMMANDS
  1240.   
  1241.   
  1242.           This  chapter  provides detailed information about each
  1243.   Twin Express command.
  1244.   
  1245.           The  full  syntax  is  given  for  each command. Square
  1246.   brackets  ([])  indicate  optional  parameters.  Braces  ({  })
  1247.   indicate a choice from a list.
  1248.   
  1249.   3.1 CHDIR
  1250.   
  1251.   Syntax: CHDIR  [~]DirectoryName
  1252.   
  1253.           Twin  Express  supports  two  default  directories: the
  1254.   local  directory and the remote directory. These are defined by
  1255.   the  volumes  and  directories  in  use  when  Twin Express was
  1256.   activated.
  1257.   
  1258.           The  CHDIR command changes the default directory of the
  1259.   local  system  or  the  remote system. The default directory is
  1260.   used  whenever  the  user  specifies a name not starting at the
  1261.   root  directory  of  a  volume  (e.g.  CHESS.C  as  opposed  to
  1262.   /GAMES/SOURCES/CHESS.C).
  1263.   
  1264.           The  name  of  a local directory is used with the CHDIR
  1265.   command  to change the local default directory. For example, to
  1266.   change the local default directory to IBMGAMES on volume B:
  1267.   
  1268.     TWIN> CHDIR  B:IBMGAMES                           or
  1269.     TWIN> CHDIR  B:/IBMGAMES                          or
  1270.     TWIN> CHDIR  B:\IBMGAMES
  1271.   
  1272.   The  default drive is changed when a volume is specified in the
  1273.   pathname,  as  in  the  example above. This also indicates that
  1274.   the  directory  specified can be found in the root directory of
  1275.   that  volume  even  though  a  slash  or  a  back-slash  is not
  1276.   specified  after  the  colon.  Note: This behavior is different
  1277.   from that of PC-DOS and MS-DOS.
  1278.   
  1279.           A  remote  directory  name is used to change the remote
  1280.   default  directory.  Since this refers to a remote resource the
  1281.   name  must have the ~ prefix. For example, to change the remote
  1282.   default directory to AMIGAMES on volume DH0:
  1283.   
  1284.     TWIN> CHDIR  ~DH0:AMIGAMES                        or
  1285.     TWIN> CHDIR  ~DH0:/AMIGAMES                       or
  1286.     TWIN> CHDIR  ~DH0:\AMIGAMES
  1287.   
  1288.   3.2 COPY
  1289.   
  1290.   Syntax: COPY  [~]SourceOfData  [~]DestinationOfData  [SUBDIR]
  1291.                 [{BINARY|TEXT}]
  1292.  
  1293.  
  1294.                              19
  1295.  
  1296.   Twin Express                                       User's Guide
  1297.  
  1298.  
  1299.  
  1300.   
  1301.           The  COPY  command  creates copies of files. Source and
  1302.   destination files may be local or remote resources.
  1303.   
  1304.           In  its  simplest  form, the command COPY uses a source
  1305.   file  and a destination file on the same computer. For example,
  1306.   to  copy  the  local  file  AUTOEXEC.BAT  into  the  local file
  1307.   AUTOEXEC.OLD  and  to  copy the remote file startup-sequence to
  1308.   remote file old-startup-sequence:
  1309.   
  1310.     TWIN> COPY  AUTOEXEC.BAT  AUTOEXEC.OLD
  1311.     TWIN> COPY  ~startup-sequence  ~old-startup-sequence
  1312.   
  1313.   As  shown  above,  the remote resources must have the ~ prefix.
  1314.   Note:  the  target file gets the same creation date and time as
  1315.   the source file.
  1316.   
  1317.           A  more useful form, from a file transfer program point
  1318.   of  view,  is when the source file and the destination file are
  1319.   not  on  the  same system. This actually transfers the contents
  1320.   of  the source file to the destination system through the cable
  1321.   connected   to  the  serial  devices  of  both  computers.  For
  1322.   example,  to  copy the local file TITLES.LIB to file NEWHITS on
  1323.   the remote system:
  1324.   
  1325.     TWIN> COPY  TITLES.LIB  ~NEWHITS
  1326.   
  1327.           Source  file  names  may contain wildcards. This allows
  1328.   the  user  to  copy  many  files  with  a  single  command. For
  1329.   example,  to  copy all the .C files of the current directory to
  1330.   the directory SOURCES:
  1331.   
  1332.     TWIN> COPY  *.C  SOURCES
  1333.   
  1334.   Note:   when  the  source  name  contains  wildcards  or  is  a
  1335.   directory  name,  the  target  name  must  be  the  name  of  a
  1336.   directory.
  1337.   
  1338.           On   request,  COPY  can  also  process  the  files  of
  1339.   subdirectories.  This  is  indicated  by the SUBDIR option. For
  1340.   example,  to  copy  all  the  remote .EXE files from the remote
  1341.   directory   GAMES,  including  all  the  .EXE  files  found  in
  1342.   sudirectories  of  directory  GAMES,  to  the  local  directory
  1343.   DEMOS:
  1344.   
  1345.     TWIN> COPY  ~GAMES/*.EXE  DEMOS  SUBDIR           or
  1346.     TWIN> COPY  ~GAMES\*.EXE  DEMOS  SUBDIR
  1347.   
  1348.   In  this  case,  Twin Express first copies matching files found
  1349.   in  the  source  directory  to  the  target  directory. It then
  1350.   copies   matching   files   found   in   each   of  the  source
  1351.   subdirectories  to  subdirectories  of  the  same  name  in the
  1352.   target  directory.  If  a matching target subdirectory does not
  1353.   exist,  Twin  Express  creates the subdirectory and then copies
  1354.  
  1355.  
  1356.                              20
  1357.  
  1358.   Twin Express                                       User's Guide
  1359.  
  1360.  
  1361.  
  1362.   the   corresponding   files  to  it.  This  produces  a  target
  1363.   directory having the same structure as the source directory.
  1364.   
  1365.          The  TEXT option indicates that the source file contains
  1366.   text  (printable characters) rather than binary data. It allows
  1367.   Twin  Express  to  translate  your text files when you transfer
  1368.   them  between  an  Amiga  and  an IBM computer. For example, to
  1369.   transfer  all  the text files from the local directory BUSINESS
  1370.   to the remote directory LETTERS:
  1371.   
  1372.     TWIN> COPY  BUSINESS  ~LETTERS  TEXT
  1373.   
  1374.   More  information about the translation process can be found in
  1375.   section  2.8  of  this manual. By default, the BINARY option is
  1376.   used and no translation is done.
  1377.   
  1378.   3.3 DELETE
  1379.   
  1380.   Syntax: DELETE  FileName  [SUBDIR]
  1381.   
  1382.           The  DELETE  command removes local or remote files from
  1383.   a file system.
  1384.   
  1385.           A  local  file  name is used with the DELETE command to
  1386.   delete   a   local  file.  For  example,  to  delete  the  file
  1387.   REPORT.OLD in the default local directory:
  1388.   
  1389.     TWIN> DELETE  REPORT.OLD
  1390.   
  1391.   To  delete a remote file, the file name must have the ~ prefix.
  1392.   For  example,  to  delete  the  remote  file  REPORT.OLD in the
  1393.   default remote directory:
  1394.   
  1395.     TWIN> DELETE  ~REPORT.OLD
  1396.   
  1397.   Usage   of  wildcards  is  permitted  with  this  command.  For
  1398.   example,  to  delete  all  the  .MAP files in the local default
  1399.   directory:
  1400.   
  1401.     TWIN> DELETE  *.MAP
  1402.   
  1403.           On  request,  DELETE  can be extended to files found in
  1404.   subdirectories.  This  is  indicated  by the SUBDIR option. For
  1405.   example, to delete all the .LST files on the remote volume C:
  1406.   
  1407.     TWIN> DELETE  ~C:*.LST  SUBDIR                    or
  1408.     TWIN> DELETE  ~C:/*.LST  SUBDIR                   or
  1409.     TWIN> DELETE  ~C:\*.LST  SUBDIR
  1410.   
  1411.   3.4 DIR
  1412.   
  1413.   Syntax: DIR  [~][PathName]  [SUBDIR]
  1414.   
  1415.           The  DIR  command  displays the names of the files in a
  1416.  
  1417.  
  1418.                              21
  1419.  
  1420.   Twin Express                                       User's Guide
  1421.  
  1422.  
  1423.  
  1424.   local  or  remote directory. The command provides the following
  1425.   data  regarding  these  files:  the  file size (bytes), date of
  1426.   last  modification,  time  of  last  modification  and the file
  1427.   attributes.  For  example,  DIR  might  display  the  following
  1428.   information:
  1429.   
  1430.     Listing of directory C:\GAMES\CHESS
  1431.   
  1432.     CHESS.BAT                193  91-03-31  09:10:47  --CA  RW-D
  1433.     CHESS.C               245002  91-09-26  15:28:18  ---A  RW-D
  1434.     CHESS.EXE             113247  91-09-26  15:31:58  ----  RWED
  1435.     CHESS.DOC              35831  91-09-27  11:55:16  ----  RW-D
  1436.     OPENINGS           Directory  91-05-25  16:29:31  ----  RWED
  1437.     CHESS.O                54645  91-09-26  15:31:04  ----  RW-D
  1438.   
  1439.     Total size of files:  448918
  1440.   
  1441.           A  local  file name is used with the DIR command to get
  1442.   information  on  a  specific  local  file.  For example, to get
  1443.   information on the local file CHESS.C:
  1444.   
  1445.     TWIN> DIR  CHESS.C
  1446.   
  1447.   To  get  information  on a remote file, the file name must have
  1448.   the  ~  prefix.  For  example, to get information on the remote
  1449.   file GRAPHLIB:
  1450.   
  1451.     TWIN> DIR  ~GRAPHLIB
  1452.   
  1453.   Usage  of  wildcard  characters  is  permitted. For example, to
  1454.   display  information about all the files having a name starting
  1455.   with HOTEL:
  1456.   
  1457.     TWIN> DIR  HOTEL*
  1458.   
  1459.   To  get  the  complete  listing  of a particular directory, the
  1460.   user  must  supply a directory name instead of a file name. For
  1461.   example:  to  get  a  complete  listing  of  files in directory
  1462.   A:\BACKUP1:
  1463.   
  1464.     TWIN> DIR  A:BACKUP1                              or
  1465.     TWIN> DIR  A:\BACKUP1
  1466.     TWIN> DIR  A:/BACKUP1
  1467.   
  1468.   To  get a complete listing of a default directory, the user has
  1469.   the  choice  of  using  the  * wildcard character or no name at
  1470.   all.  For  example,  to  display  all  the  files of the remote
  1471.   default directory:
  1472.   
  1473.     TWIN> DIR  ~                                     or
  1474.     TWIN> DIR  ~*
  1475.   
  1476.   The  SUBDIR  option  can  be  used to also display the matching
  1477.   files  in subdirectories. For example: to get a list of all the
  1478.  
  1479.  
  1480.                              22
  1481.  
  1482.   Twin Express                                       User's Guide
  1483.  
  1484.  
  1485.  
  1486.   files having the .OLD extension on the current volume:
  1487.   
  1488.     TWIN> DIR  :*.OLD  SUBDIR                        or
  1489.     TWIN> DIR  /*.OLD  SUBDIR                        or
  1490.     TWIN> DIR  \*.OLD  SUBDIR
  1491.   
  1492.           The  file attributes define some characteristics of the
  1493.   file. Twin Express supports the following attributes:
  1494.   
  1495.     S: File is a system file.
  1496.     H: File is normally hidden.
  1497.     C: File is a command file (batch file, script file).
  1498.     P: File contains pure, re-entrant code.
  1499.     A: File has been archived since its last modification.
  1500.     R: File can be read (not read protected).
  1501.     W: File can be written, modified (not write protected).
  1502.     E: File can be executed (not execute protected).
  1503.     D: File can be deleted (not delete protected).
  1504.   
  1505.   Not  all  these attributes are supported on all of the systems.
  1506.   Twin  Express running on the IBM-PC or compatible machines does
  1507.   not  support the attribute P and simulates the attributes C, R,
  1508.   W, E, D.
  1509.   
  1510.   3.5 ECHO
  1511.   
  1512.   Syntax: ECHO UserText
  1513.   
  1514.           ECHO  displays  on the screen the text that follows the
  1515.   command.  For  example, to get the message "Remote Backup" upon
  1516.   the execution of the command ECHO:
  1517.   
  1518.     TWIN> ECHO Remote Backup
  1519.   
  1520.   The  purpose  of  this  command is to display comments when the
  1521.   input  to  Twin  Express  comes from a command file rather than
  1522.   the keyboard.
  1523.   
  1524.   3.6 HELP
  1525.   
  1526.   Syntax: HELP  [{TWIN|CABLE|USAGE|COMMANDS|EXAMPLES}]
  1527.   
  1528.           The  HELP  command  provides on-line information to the
  1529.   user.
  1530.   
  1531.           The  command  may  be used with or without a parameter.
  1532.   Without  a  parameter,  it  is a request for information on the
  1533.   command itself. Example:
  1534.   
  1535.     TWIN> HELP
  1536.   
  1537.   In  this  case,  the command only displays the topics for which
  1538.   help  is  available.  Actually,  the  user  can get information
  1539.   about  registration (TWIN), information about the wiring of the
  1540.  
  1541.  
  1542.                              23
  1543.  
  1544.   Twin Express                                       User's Guide
  1545.  
  1546.  
  1547.  
  1548.   null-modem  cable  used  for  the  serial transfers (CABLE), an
  1549.   introduction  to  the  basic  operations  (USAGE),  the command
  1550.   syntax (COMMANDS) and some typical examples (EXAMPLES).
  1551.   
  1552.           For  more  detailed  information,  the  topic  must  be
  1553.   specified  in the command. For example, to display a summary of
  1554.   all the commands:
  1555.   
  1556.     TWIN> HELP  COMMANDS
  1557.   
  1558.   3.7 MKDIR
  1559.   
  1560.   Syntax: MKDIR  [~]DirectoryName
  1561.   
  1562.           The  MKDIR  command creates a new directory in the file
  1563.   system of the local or the remote computer.
  1564.   
  1565.           A  local  directory  name  is  used  to  create a local
  1566.   directory.  For  example, to create the subdirectory IBMNEWS in
  1567.   the current default directory:
  1568.   
  1569.     TWIN> MKDIR  IBMNEWS
  1570.   
  1571.   A  ~  prefix  is used at the beginning of the directory name to
  1572.   create   a   remote  directory.  For  example,  to  create  the
  1573.   directory AmiNews in the remote root directory:
  1574.   
  1575.     TWIN> MKDIR  ~/AmiNews                            or
  1576.     TWIN> MKDIR  ~\Aminews                            or
  1577.     TWIN> MKDIR  ~:AmiNews
  1578.   
  1579.   3.8 QUIT
  1580.   
  1581.   Syntax: QUIT
  1582.   
  1583.           This   command  allows  the  user  to  exit  from  Twin
  1584.   Express.  Note  that you also exit from the remote program if a
  1585.   connection had been established with the remote.
  1586.   
  1587.           After  exiting  from  the  program  you are left in the
  1588.   directory  from  which  you  activated  Twin  Express even if a
  1589.   different  default  directory  (via  CHDIR)  had  been selected
  1590.   during your session with the program.
  1591.   
  1592.   3.9 RENAME
  1593.   
  1594.   Syntax: RENAME  [~]SourceName  [~]TargetName  [SUBDIR]
  1595.   
  1596.           The  RENAME command changes the current name of a local
  1597.   or a remote file to a new name.
  1598.   
  1599.           The  current name and the new name are the two required
  1600.   parameters  to this command. For example, to change the name of
  1601.   the local file TEST.ASM to DONJON.ASM:
  1602.  
  1603.  
  1604.                              24
  1605.  
  1606.   Twin Express                                       User's Guide
  1607.  
  1608.  
  1609.  
  1610.   
  1611.     TWIN> RENAME  TEST.ASM  DONJON.ASM
  1612.   
  1613.   You  can  also  "rename"  the  file  so as to change its parent
  1614.   directory.  This  actually moves the file to another directory.
  1615.   For example, to move file DONJON.ASM to the directory GAMES:
  1616.   
  1617.     TWIN> RENAME  DONJON.ASM  :GAMES                  or
  1618.     TWIN> RENAME  DONJON.ASM  /GAMES                  or
  1619.     TWIN> RENAME  DONJON.ASM  \GAMES
  1620.   
  1621.   Usually,  most systems won't allow the user to rename a file to
  1622.   a  different  volume. In this case, the user must copy the file
  1623.   to the new volume and delete the old file.
  1624.   
  1625.           Both  the current name and the new name must have the ~
  1626.   prefix  to  rename  a  remote  file. For example, to change the
  1627.   name  of  remote  file  TEST.PAS to DRAGON.PAS in the directory
  1628.   GAMES of the remote computer:
  1629.   
  1630.     TWIN> RENAME  ~TEST.PAS  ~:GAMES/DRAGON.PAS       or
  1631.     TWIN> RENAME  ~TEST.PAS  ~:GAMES\DRAGON.PAS       or
  1632.     TWIN> RENAME  ~TEST.PAS  ~/GAMES/DRAGON.PAS       or
  1633.     TWIN> RENAME  ~TEST.PAS  ~\GAMES\DRAGON.PAS
  1634.   
  1635.   The  ~  prefix is required in both names, otherwise the meaning
  1636.   would  be  "move  file  to  another  system"  which  is not the
  1637.   purpose of this command.
  1638.   
  1639.           The  command RENAME also supports the use of wildcards.
  1640.   This  is  used  to  move  a  selected group of files to another
  1641.   directory.  For  example, to move all the files ending in .C to
  1642.   the directory CSTUFF:
  1643.   
  1644.     TWIN> RENAME  *.C  :CSTUFF                        or
  1645.     TWIN> RENAME  *.C  /CSTUFF                        or
  1646.     TWIN> RENAME  *.C  \CSTUFF
  1647.   
  1648.   With  such a command, all the selected files are moved to a new
  1649.   directory. However, all of them keep their original name.
  1650.   
  1651.   3.10 RMDIR
  1652.   
  1653.   Syntax: RMDIR  [~]DirectoryName
  1654.   
  1655.           The   RMDIR   command  removes  a  local  or  a  remote
  1656.   directory from the file system.
  1657.   
  1658.           The  name  of  a local directory is used with the RMDIR
  1659.   command  to  delete  a  local  directory  from  the system. For
  1660.   example,  to  remove  the  local subdirectory OLDSTUFF from the
  1661.   current default directory:
  1662.   
  1663.     TWIN> RMDIR  OLDSTUFF
  1664.  
  1665.  
  1666.                              25
  1667.  
  1668.   Twin Express                                       User's Guide
  1669.  
  1670.  
  1671.  
  1672.   
  1673.   A  remote  directory  name must have the ~ prefix. For example,
  1674.   to   delete   the  directory  OBSOLETE  from  the  remote  root
  1675.   directory:
  1676.   
  1677.     TWIN> RMDIR  ~:OBSOLETE                           or
  1678.     TWIN> RMDIR  ~/OBSOLETE                           or
  1679.     TWIN> RMDIR  ~\OBSOLETE
  1680.   
  1681.   Most  systems prohibit deletion of non-empty directories, which
  1682.   is  a good security feature. The user must remove all the files
  1683.   and any subdirectories from the directory before deleting it.
  1684.   
  1685.   3.11 SET
  1686.   
  1687.   
  1688.   Syntax: SET MODE {STANDARD|EXPRESS}
  1689.   
  1690.           The  SET command allows a user to select one of the two
  1691.   serial  transmission  modes.  These  are:  STANDARD  (the basic
  1692.   mode) and EXPRESS (a high speed mode).
  1693.   
  1694.           The  STANDARD  mode transmits data at the speed defined
  1695.   by  the current baud rate. At 115200 baud, it transfers data at
  1696.   about  11,000 bytes per second. This is the default mode. It is
  1697.   also  the  mode recommended when transmission errors occur with
  1698.   the high speed mode.
  1699.   
  1700.           The  EXPRESS  mode  is a high speed mode that transmits
  1701.   more  data  than  the  standard  mode for a given baud rate. At
  1702.   115200  baud,  it  transfers  data  at  about  22,000 bytes per
  1703.   second on 12.5 MHz AT-type computers.
  1704.   
  1705.           There  is  no  need  to  type  a  SET  command  on both
  1706.   machines.  Twin Express automatically puts the remote system in
  1707.   the  same mode. For example, to enable the EXPRESS mode on both
  1708.   computers:
  1709.   
  1710.     TWIN> SET  MODE  EXPRESS
  1711.   
  1712.   3.12 SHOW
  1713.   
  1714.   Syntax: SHOW {DEVICE|BAUD|SPEED|STATUS|PATH}
  1715.   
  1716.           The  SHOW  command  allows  a  user  to get information
  1717.   about  the  current  device,  current baud rate, current speed,
  1718.   default directories or status.
  1719.   
  1720.           The  DEVICE option indicates the current serial port in
  1721.   use on the local computer.
  1722.   
  1723.           The  BAUD option indicates the current baud rate in use
  1724.   on the local computer.
  1725.   
  1726.  
  1727.  
  1728.                              26
  1729.  
  1730.   Twin Express                                       User's Guide
  1731.  
  1732.  
  1733.  
  1734.           The  SPEED  option  indicates  the  estimated  transfer
  1735.   speed  (in bytes per second) according to the current baud rate
  1736.   and selected mode.
  1737.   
  1738.           The  PATH  option  indicates  the  default  directories
  1739.   (local and remote).
  1740.   
  1741.           The  STATUS  option  displays the type of the local and
  1742.   the  remote  systems  (Amiga  or  IBM compatible), the names of
  1743.   local  and  remote ports and type of cable (3 or 7 wires) being
  1744.   used.
  1745.   
  1746.           For   example,   to   display   information  about  the
  1747.   estimated transfer speed:
  1748.   
  1749.     TWIN> SHOW  SPEED
  1750.   
  1751.   3.13 TREE
  1752.   
  1753.   Syntax: TREE [~][DirectoryName]
  1754.   
  1755.           The  TREE command displays the structure of a directory
  1756.   and  of all the subdirectories nested within it. For example, a
  1757.   GAMES directory might have the following structure:
  1758.   
  1759.     GAMES
  1760.       ADVENTURE
  1761.         MS-TREK
  1762.         COMBAT
  1763.       ARCADE
  1764.         BRICKS
  1765.         PINBALL
  1766.       MISC
  1767.         GAMBLING
  1768.           BLACKJACK
  1769.         BOARDS
  1770.           CHESS
  1771.           CHECKERS
  1772.         CARDS
  1773.           BRIDGE
  1774.   
  1775.           A  local  directory  name is used with the TREE command
  1776.   to  display the structure of a local directory. For example, to
  1777.   view the directory structure of the local directory GAMES:
  1778.   
  1779.     TWIN> TREE GAMES
  1780.   
  1781.   The  directory name is not required to get the structure of the
  1782.   default directory.
  1783.   
  1784.           A  directory  name  with  a ~ prefix is used to display
  1785.   the  structure  of a remote directory. For example, to view the
  1786.   directory structure of the remote directory GAMES:
  1787.   
  1788.  
  1789.  
  1790.                              27
  1791.  
  1792.   Twin Express                                       User's Guide
  1793.  
  1794.  
  1795.  
  1796.     TWIN> TREE ~GAMES
  1797.   
  1798.   3.14 TYPE
  1799.   
  1800.   Syntax: TYPE TextFileName
  1801.   
  1802.           The  TYPE command displays the contents of a local or a
  1803.   remote  text  file,  one page at a time. The user may abort the
  1804.   command by typing <CTRL-C>.
  1805.   
  1806.           A  local  name is used with the TYPE command to display
  1807.   a  local  text  file.  For  example,  to display the local file
  1808.   AUTOEXEC.BAT:
  1809.  
  1810.     TWIN> TYPE  AUTOEXEC.BAT
  1811.  
  1812.     To  display a remote text file, the file name must have
  1813.   the   ~  prefix.  For  example,  to  display  the  remote  file
  1814.   startup-sequence:
  1815.  
  1816.     TWIN> TYPE  ~startup-sequence
  1817.  
  1818.   You  can  display remote text files even if the remote computer
  1819.   is  not  compatible  with the local computer (e.g. Amiga vs IBM
  1820.   PC).  In  this  case,  Twin  Express will translate the file as
  1821.   described in section 2.8 of this manual.
  1822.  
  1823.  
  1824.  
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.                              28
  1853.  
  1854.   Twin Express                                       User's Guide
  1855.  
  1856.  
  1857.  
  1858.   
  1859.                            ERROR MESSAGES
  1860.   
  1861.   
  1862.           Errors  fall  in  three  classes: startup errors, usage
  1863.   errors and communication errors.
  1864.   
  1865.   Startup errors:
  1866.   
  1867.           Startup  errors  are  problems detected upon activation
  1868.   of Twin Express. Section 1.7 describes these errors in detail.
  1869.   
  1870.   Usage errors:
  1871.   
  1872.           Usage  errors indicate mistakes in a user command (e.g.
  1873.   bad  command,  missing  parameters) or an error detected during
  1874.   execution  of  a  command. These messages always start with the
  1875.   word  "Error".  For  example, an error message indicating a bad
  1876.   command:
  1877.   
  1878.     Error: Invalid command.
  1879.   
  1880.   A  usage  error always terminates the program when the input is
  1881.   from a command file.
  1882.   
  1883.   Communication errors:
  1884.   
  1885.           Communication   errors   are   indicated   by  messages
  1886.   enclosed  between  >>>  and  <<<.  The  message  specifies some
  1887.   unusual  conditions  related  to  communication with the serial
  1888.   link. You should not see many of them under normal conditions.
  1889.   
  1890.           Most  communication  error  messages  indicate  that an
  1891.   error  was found in a block of data. These errors are generated
  1892.   by   bad   connections,   high  baud  rates,  long  cables  and
  1893.   electrical  interference.  As  a  result, one or more bits have
  1894.   been  changed  in  a  block  of data transmitted via the serial
  1895.   cable.   This  condition  may  produce  one  of  the  following
  1896.   messages:
  1897.   
  1898.     >>> Last packet data transmitted with error <<<
  1899.     >>> Last packet header transmitted with error <<<
  1900.     >>> Last packet data received with error <<<
  1901.     >>> Last packet header received with error <<<
  1902.   
  1903.   In  this  case,  Twin Express retransmits the block of data and
  1904.   the  corrupted  block  is  discarded. It does not mean that the
  1905.   transmitted  files  contain these transmission errors. However,
  1906.   if  you  have  many  of these errors (say more than one error /
  1907.   million  bytes) you should consider using a slower transmission
  1908.   mode  or  a  slower  baud  rate  to  avoid  possible undetected
  1909.   errors.
  1910.   
  1911.           Retransmission  of bad blocks of data may produce other
  1912.  
  1913.  
  1914.                              A1
  1915.  
  1916.   Twin Express                                       User's Guide
  1917.  
  1918.  
  1919.  
  1920.   types  of messages under some circumstances. As before, it does
  1921.   not   mean   that   errors   have  been  introduced  into  your
  1922.   transmitted  files  (serious errors abort the program instead).
  1923.   These messages are:
  1924.   
  1925.     >>> Duplicate of a packet (packet ignored) <<<
  1926.     >>> Unexpected collision of two packets <<<
  1927.     >>> Collision of two packets (recovered) <<<
  1928.     >>> Fatal collision of two packets detected <<<
  1929.     >>> Fatal packet numbering errors <<<
  1930.   
  1931.   These  messages  might  also  appear  as a result of a software
  1932.   problem.  Please  contact  OMNICODE if you repeatedly get these
  1933.   messages at a low baud rate.
  1934.   
  1935.           Once  in  a  while  you  might see one of the following
  1936.   messages:
  1937.   
  1938.     >>> Break detected: bad device or cable problem <<<
  1939.     >>> Remote computer does not respond <<<
  1940.     >>> Waiting for remote to reply <<<
  1941.   
  1942.   They  usually  indicate  a  cable with a bad connection, a dis-
  1943.   connected  cable  or  a  program  waiting  for  completion of a
  1944.   system  request.  You  should  check whether the cable is still
  1945.   properly  connected or whether you have a system request on the
  1946.   remote computer.
  1947.   
  1948.        The  remaining  errors  are usually encountered during the
  1949.   debugging  of  the  communication  protocol  or with a very bad
  1950.   serial  link.  If  you get one of the following messages, check
  1951.   your  cable  and  try  to  execute  the program at a lower baud
  1952.   rate:
  1953.   
  1954.     >>> Sender got an out of sync ACK/NAK/SYN/CAN <<<
  1955.     >>> Receiver got an out of sync ACK/NAK/SYN/CAN <<<
  1956.     >>> Sender received an unrecognized reply <<<
  1957.     >>> Receiver got an unrecognized character <<<
  1958.     >>> Time-out while receiving packet header <<<
  1959.     >>> Receiver failed to acknowledge packet header <<<
  1960.     >>> Time-out while receiving packet data <<<
  1961.     >>> Sender failed to send data checksum <<<
  1962.     >>> Receiver failed to acknowledge packet data <<<
  1963.   
  1964.   
  1965.  
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.  
  1974.  
  1975.  
  1976.                              A2
  1977.  
  1978.   Twin Express                                       User's Guide
  1979.  
  1980.  
  1981.  
  1982.   
  1983.                          LICENSE AGREEMENT
  1984.   
  1985.   
  1986.           In   consideration  of  payment  of  the  license  fee,
  1987.   OMNICODE   grants  the  licensee  the  following  non-exclusive
  1988.   rights:
  1989.   
  1990.     1. The  licensee  owns  the  media  on  which the software is
  1991.        distributed.   However,   the   software  itself  and  the
  1992.        documentation remain the property of OMNICODE.
  1993.   
  1994.     2. The  licensee may install and use this software on as many
  1995.        computers  as  have  been  registered. The initial license
  1996.        (registration) is valid for two computers.
  1997.   
  1998.     3. Each  of  the  computers  on  which  the software has been
  1999.        installed may be used by any number of users.
  2000.   
  2001.     4. The  licensee  may  move the software from one computer to
  2002.        another  as  long  as the number of computers that use the
  2003.        software  does  not  exceed  the  number  of computers for
  2004.        which the license costs have been paid.
  2005.   
  2006.           All  rights not expressly granted in this agreement are
  2007.   reserved by OMNICODE.
  2008.   
  2009.  
  2010.  
  2011.  
  2012.  
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.                              B1
  2039.  
  2040.   Twin Express                                       User's Guide
  2041.  
  2042.  
  2043.  
  2044.   
  2045.                       DISTRIBUTION STATEMENT
  2046.   
  2047.   
  2048.           For  the  purposes  of  this  distribution statement, a
  2049.   distributor   is  any  person,  organization,  club,  group  or
  2050.   company  making  the Twin Express package available to somebody
  2051.   else.
  2052.   
  2053.           Permission  is  hereby  granted  to  any distributor to
  2054.   copy,  distribute,  or  store  this  package  in  a library, an
  2055.   information  system  or  a bulletin board system as long as all
  2056.   the following rules are respected:
  2057.   
  2058.     1.  The package may not be sold or leased out.
  2059.   
  2060.     2.  The  package  may  not  be bound, attached or linked to a
  2061.         salable  product.  In particular, it may not be installed
  2062.         on  the hard disk of a computer being sold or distributed
  2063.         with any commercial product.
  2064.   
  2065.     3.  Notwithstanding  rule  2,  a  distributor  may  charge  a
  2066.         reasonable  fee  to  cover  the cost of a diskette and/or
  2067.         mailing and/or handling and/or connect time.
  2068.   
  2069.     4.  The  package  may not be distributed via a disk magazine.
  2070.         For  the purposes of this rule, a disk magazine is either
  2071.         a  magazine  normally sold with an accompanying disk or a
  2072.         simple  advertising  cover  containing a disk. These disk
  2073.         magazines  are  usually  found  in  bookstores with other
  2074.         computer magazines.
  2075.   
  2076.     5.  Notwithstanding  rules  2  and  4,  the  publisher  of  a
  2077.         standard  magazine  may  offer, as a separate service, to
  2078.         send  a copy of this package to its readers or to make it
  2079.         available  for  downloads. For the purposes of this rule,
  2080.         a  standard  magazine  is  a  magazine  sold  without  an
  2081.         accompanying disk.
  2082.   
  2083.     6.  Distribution  of  a printed copy of the documentation, in
  2084.         whole or in part, is prohibited.
  2085.   
  2086.     7.  With  one  exception,  the  package  may not be modified.
  2087.         That  is,  the  files  included in the package may not be
  2088.         modified,  substituted,  deleted  or  mixed with files of
  2089.         other  software.  However,  the distributor may add files
  2090.         describing its distribution service to the package.
  2091.   
  2092.     8.  All  the  files  included  in the package must be distri-
  2093.         buted  together.  The package shall be distributed via an
  2094.         archive  file  (library  format)  or  as  files stored in
  2095.         their own directory.
  2096.   
  2097.     9.  A  distribution  diskette  may have many archive files or
  2098.  
  2099.  
  2100.                              C1
  2101.  
  2102.   Twin Express                                       User's Guide
  2103.  
  2104.  
  2105.  
  2106.         directories  containing  other shareware or public domain
  2107.         software.
  2108.   
  2109.     10. The  distributor  may  not distribute the package as free
  2110.         software  or  public  domain software. Whenever possible,
  2111.         the  distributor  shall  indicate  that  the  package  is
  2112.         shareware software.
  2113.   
  2114.     11. The  distributor  agrees  to  stop  distribution  of this
  2115.         package as soon as notified by OMNICODE.
  2116.   
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.                              C2
  2163.  
  2164.   Twin Express                                       User's Guide
  2165.  
  2166.  
  2167.  
  2168.   
  2169.                         PROBLEM REPORT FORM
  2170.   
  2171.   
  2172.   DATE           ________________________________________________
  2173.   NAME           ________________________________________________
  2174.   COMPANY        ________________________________________________
  2175.   ADDRESS        ________________________________________________
  2176.                  ________________________________________________
  2177.                  ________________________________________________
  2178.                  Country ___________ Zip code  __________________
  2179.   TEL            ___________________ FAX       __________________
  2180.   REGISTRATION # ___________________ (required for a reply...)   
  2181.   
  2182.   
  2183.   PRODUCT        Twin Express_______ RELEASE   __________________
  2184.   
  2185.   
  2186.   COMPUTER BRAND _______________ OPERATING SYSTEM _______________
  2187.   CPU TYPE       _______________ RELEASE          _______________
  2188.   CPU CLOCK      _______________ FLOPPY DISK TYPE _______________
  2189.   
  2190.   
  2191.   PROBLEMS,      ________________________________________________
  2192.   ENHANCEMENTS,  ________________________________________________
  2193.   SUGGESTIONS,   ________________________________________________
  2194.   REQUESTS...    ________________________________________________
  2195.                  ________________________________________________
  2196.                  ________________________________________________
  2197.                  ________________________________________________
  2198.                  ________________________________________________
  2199.                  ________________________________________________
  2200.                  ________________________________________________
  2201.                  ________________________________________________
  2202.                  ________________________________________________
  2203.                  ________________________________________________
  2204.                  ________________________________________________
  2205.   
  2206.   Note: if possible, indicate how to reproduce the problem.
  2207.   
  2208.   Send to OMNICODE
  2209.           P.O. Box 128 Ahuntsic
  2210.           Montréal [Québec]
  2211.           CANADA H3L 3N7                 FAX: (514)385-6455
  2212.   
  2213.  
  2214.  
  2215.  
  2216.  
  2217.  
  2218.  
  2219.  
  2220.  
  2221.  
  2222.  
  2223.  
  2224.                              D1
  2225.  
  2226.   Twin Express                                       User's Guide
  2227.  
  2228.  
  2229.  
  2230.   
  2231.                     REGISTRATION AND ORDER FORM
  2232.   
  2233.   
  2234.   DATE           ________________________________________________
  2235.   NAME           ________________________________________________
  2236.   COMPANY        ________________________________________________
  2237.   ADDRESS        ________________________________________________
  2238.                  ________________________________________________
  2239.                  ________________________________________________
  2240.                  Country ____________ Zip code  _________________
  2241.   TEL            ____________________ FAX       _________________
  2242.   REGISTRATION # ____________________ (required for items 2 - 3) 
  2243.   
  2244.   COMPUTER BRAND _______________ OPERATING SYSTEM _______________
  2245.   CPU TYPE       _______________ RELEASE          _______________
  2246.   CPU CLOCK      _______________ FLOPPY DISK TYPE _______________
  2247.   
  2248.   COMPUTER BRAND _______________ OPERATING SYSTEM _______________
  2249.   CPU TYPE       _______________ RELEASE          _______________
  2250.   CPU CLOCK      _______________ FLOPPY DISK TYPE _______________
  2251.   
  2252.   HOW DID YOU GET A COPY OF TWIN EXPRESS (a-g) ?  _______________
  2253.     a) Friend                         Name & address of d,e,f,g
  2254.     b) Office                         ___________________________
  2255.     c) Information system (e.g. BIX)  ___________________________
  2256.     d) Bulletin Board System (BBS)    ___________________________
  2257.     e) Users group - club             ___________________________
  2258.     f) Shareware distributor          ___________________________
  2259.     g) Other ________________________ ___________________________
  2260.   
  2261.   EXPECTED USAGE OF TWIN EXPRESS:
  2262.   _______________________________________________________________
  2263.   _______________________________________________________________
  2264.   _______________________________________________________________
  2265.   _______________________________________________________________
  2266.   _______________________________________________________________
  2267.   
  2268.   YOUR COMMENTS ABOUT TWIN EXPRESS:
  2269.   _______________________________________________________________
  2270.   _______________________________________________________________
  2271.   _______________________________________________________________
  2272.   _______________________________________________________________
  2273.   _______________________________________________________________
  2274.   
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.                              E1
  2287.  
  2288.   Twin Express                                       User's Guide
  2289.  
  2290.  
  2291.  
  2292.   
  2293.   QTY                    PRODUCT                          PRICE  
  2294.   
  2295.   ___ Registration for 2 computers             (30.00 $) ________
  2296.         (includes 1 manual and 2 diskettes)
  2297.   
  2298.   ___ Extra license for 1 computer             (10.00 $) ________
  2299.   
  2300.   ___ Extra manual                              (9.00 $) ________
  2301.   
  2302.   ___ Latest update diskettes                   (7.00 $) ________
  2303.   
  2304.                                                   Total: ________
  2305.   
  2306.   
  2307.   
  2308.   
  2309.   
  2310.   
  2311.   All prices are in Canadian dollars.
  2312.   Prices are subject to change without notice.
  2313.   Prices include Canadian taxes where applicable.
  2314.   Use a money order or a check drawn on a Canadian bank.
  2315.   
  2316.   
  2317.   
  2318.   
  2319.   
  2320.   
  2321.   Send to OMNICODE
  2322.                     P.O. Box 128 Ahuntsic
  2323.                     Montréal [Québec]
  2324.                     CANADA H3L 3N7
  2325.  
  2326.